APPENDIX D 



Add Report Definition 



Message 


Parameter Name 


: Pa ram 
Type 


Required 


Acceptable Value 


ARD 


Request 


Char (3) 


Yes 




ENTPID= 


Enterprise ID 


Char (8) 


Yes 


Enterprise ID 


USERID= 




Char ^20^ 


Yes 


UsprlD 


STDRPTID= 


Standard Report 
ID 


Char (10) 


Yes 


Standard Report 
ID (i.e.. 2. 44). 


USERRPTID 


User's Report ID 


Char (10) 


Yes 


User Report ID 
(i.e.. 345). Limit 
on unique user 
report IDs is 

i£ 1 •+/ *tOOD*t/ . 


REQUESTID 


Unique Request 
ID 


Char (10) 


Yes 


Unique Request 
ID. Limit is 
2147483647 


PRODUCT= 


Product 


Char (1) 


Yes 


Vnet = V. CVNS = 
C. Vision = S. Toll 
Free = T, 
Broadband = H 


THRESHOLD 


Record limits 


Delimiter 


Yes 


RECCOUNT. 
RANKING. 
DURATION, ANI 


RECCOUNT 


Record count 


Char (10) 


No 


Maximum amount 
of records to be 
returned in the 
report results. If no 
threshold is 
received, the 
default reccount 
threshold from the 
report template will 
be passed. 


RANKING= 


TVS Ranking 


Char (3) 


No 


# of call ranks to 
show. If ranking is 
not passed, the 
default value will 
be passed. This is 
a TVS only 
parameter. Range 
is 1-400. 



Add Report Definition 



Message 1 


P>arameter Name 


Param 
Type 


Required 


Acceptable Value j 


DURATION= 


TVS Duration 


Char (4) 


No 


# for call duration 
threshold. If 
duration is not 
passed, the default 
value will be 
passed. This is a 
TVS only 
parameter. 
Format is mmss. 
Range is 1-5959. 


ANi= 


TVS AN! 


Char (3) 


No 


# of Items in Most 
Frequent report. If 
ANI is not passed, 
the default value 
will be used. This 
is a TVS only 
parameter. Range 
is 1-400. 


COLUMNS= 


Columns 


Char 


Yes 


These are the 
columns the user 
wants in their 
report. Field Ids 
are to be passed 
here (i.e., 5,17, 
23,44). 


FILTERS= 


Filters or Criteria 


Delimiter 


Yes for 


Contains multiple 
filters (i.e., 
NDIALED). If 
filters are not 
received, filters 
from the standard 
report template (if 
any) will be stored 
and/or sent with 
request to fulfilling 
server. 


NDIALED= 


Filter 


Char 


Yes for 
TVS, no for 
all others 


Number range 


BILL1NG= 


Hierarchy 


Char 


Yes for 
ODS, Yes 
for TVS 
Vision and 
VNET 
Outbound 


Single or multiple 
values from billing 
hierarchy. Must at 
least include the 
Corp ID 


DURRANGE 


Duration Range 


Char 


No 


Single or multiple 
values. 



Add Report Definition 



Message F 


>arameter Name 


Param 
Type 


Required 


Acceptable Value ■ 


CARDNO= 


Card Number 


Char 


No 


bingie or mumpie 
values from the 
duration pick list 


IDISTRANGE 


Inbound Range 


Char 


No 


Single or multiple 
values from the 
Range pick list 


ODISTRANG 


Outbound Range 


Char 


No 


Single or multiple 
values from the 

R^nnp nirk li^t 

ncii ly w ^iv^rx iioi 


IUSAGE= 


Inbound Usage 


Char 


No 


Single or multiple 
values from the 
Usage pick list 


OUSAGE= 


Outbound Usage 


Char 


No 


Single or multiple 
values from the 
Usage pick list 


IDAC= 


ID/Account Codes 


Char . 


No 


Single or multiple 
values 




nponraohical 


Char 


No 


Single or multiple 
values from 
geographical 
hierarchy. 


IACCESS= 


Inbound Access 


Char 


No ' 


Single or multiple 
values of inbound 
access items 


OACCESS= 


Outbound Access 


Char 


No 


Single or multiple 
values of outbound 
access items 


SORTBY= 


Sort Order 


Char 


Yes 


If sort order is not 
received, sort 
order for standard 
report will be used. 
If sort order is 

naccpH it mu^t hfi 

a column ID and 
ascending (A) or 
descending (D) 
(i.e.,1D). 


TIMEZONE= 


Timezone info. 


Delimiter 


Yes 


LABEL and 
OFFSET. 


LABEL= 


Time description 


Char (3) 


Yes 


Timezone label (ie, 
MST). 
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Add Report Definition 



Message F 


»arameter Name 


Param 1 
Type 


={equired 


Acceptable Value ■ 


OFFSET= 


GMT offset 


Char (5 


Yes 


Users Time zone 
n relation to GMT 
e.g. +2. -5. Valid 
range is -12 
through +13. 
Offsets will be in 1 
hour increments 
for the 98.1 
release. 


SCHEDULE= 


Report schedule 


onar \} 


I CO 


The Reoort 
Scheduler will not 
send a request to 
the fulfilling server 
if the report was 
not scheduled. 

A = Adhoc, H = 
Hourly, D = Daily. 
W= Weekly. M = 
Monthly 


START= 


Start report 
schedule 


Char (12) 


Yes 


YYYYMMDDhhm 
m 

This parameter is 
only used if the 
report is Adhoc. 
These can be 
multiple start and 
end dates. Start 
and end times 
must be passed in 
pairs and will be in 
GMT format. 


END= 


End report 
schedule 


Char (12) 


Yes 


YYYYMMDDhhm 
m 

This parameter is 
only used if the 
report is Adhoc. 
There can be 
multiple start and 
end dates. Start 
and end times 
must be passed in 
pairs and will be in 
GMT format. 


TOTALMOD 
E= 


Total mode the 
user selected. 


Char(1) 


Yes for 
CDS, No for 
all other 
fulfilling 
servers. 


0 = None (default). 

1 = Subtotal. 2 = 
Total.5 = Both. „ 



r I 
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Add Report Definition 



Message 


Parameter Name 


Param 
Type 


Required 


Acceptable Value 


SUBTOTCOL 


Subtotal columns 


Char 


Yes if 


Subtotal column 








TOTALMO 


IDs. 








DE is 1 or 3. 





Add Report Definition Acknowledgment 



Message 


; Parameter 
iName 


; Param ; 
Type 


\ Required 


Acceptable Value 


ARDA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


USERRPTID 


User Report ID 


Char (10) 


No 


User Report ID 
(i.e., 245). Limit on 
unique user report 
Ids is 2147483647. 
Please use this 
token whenever 
possible. The only 
time it should not 
be used is when 
the fulfilling server 
cannot parse the 
message at all. 


REQUESTID 


Unique Request 
ID 


Char (10) 


Yes 


Request ID. Limit 
is 2147483647. 



